Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Media Functions / Selecting Media Handlers

GetMediaHandler

The GetMediaHandler function allows you to obtain a reference to a media handler component.

You can use this reference to call the media handler directly. See "Video Media Handler Functions," which begins on page 2-269, and "Sound Media Handler Functions," which begins on page 2-271, for information about the functions that are supported by video and sound media handlers.

pascal MediaHandler GetMediaHandler (Media theMedia); 

theMedia

Specifies the media for this operation. Your application obtains this media identifier from such Movie Toolbox functions as NewTrackMedia and GetTrackMedia (described on page 2-138 and page 2-190, respectively).

DESCRIPTION

The GetMediaHandler function returns a reference to the media's media handler. If the function could not locate the media handler, it sets this reference to nil. You can use this reference to call the media handler.

ERROR CODES

invalidMedia

-2008

This media is corrupted or invalid